home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / comm / misc / nVmDIZ.lha / nVmDIZ / nVmDIZ.doc < prev    next >
Encoding:
Text File  |  1997-07-08  |  5.7 KB  |  183 lines
  1.  
  2.                     nVmDIZ 0.5 by bEAt lORd of nEVERmIND
  3.  
  4.  Introduction:
  5.  
  6. nVmDIZ is tool for making file_id.diz's of AmiNet .readme files. Recently
  7. I've got full Internet access, and I've taken a few things... and I 
  8. noticed that I need something like that. Other reason is that I've taken
  9. AMOSPro GUI extension and I wanted to see how it works. Meanwhile I've
  10. found some other tools that doing this (like DODiz or Dizzy), but there were
  11. no GUI, nor they (at least some of them;) were configurable in a way nVmDIZ
  12. is.
  13.  
  14. Yeah, right. Meanwhile, DODiz is greatly enhanced, it now has more featres
  15. then nVmDIZ (except GUI) and is more stable. I got almost NONE feedback, so I
  16. decided to quit working on nVmDIZ. Thanks to everyone who did write to me
  17. anyway!
  18.  
  19.  Installation:
  20.  
  21. Use supplied nVmDIZ_install Installer script. Else, you could install nVmDIZ
  22. manualy: copy it wherever you want, and copy nVmDIZ.diz and nVmDIZ.archivers to
  23. ENVARC: That should be all.
  24.  
  25.  Configuration:
  26.  
  27.   Via Tooltypes:
  28.  
  29.  There are 5 tooltypes right now:
  30.  WINX   = Window X coordinate.
  31.  WINY   = Window Y coordinate.
  32.  IWX    = Iconified window X coordinate.
  33.  IWY    = Iconified window Y coordinate.
  34.  DEFDIR = Default directory with your archives.
  35.  REPLACE= (ALWAYS|NEVER|ASK), will file_id.diz be replaced if it is in
  36. archive.
  37.  EDITOR = Name of text editor you want to use. It could be run
  38. asynchronously.
  39.  COMMENT= String that will be in Comment gadget.
  40.  
  41.   Via nVmDIZ.archivers file:
  42.  
  43.  nVmDIZ.archivers contains information about archive types you may encounter.
  44.  It can be edited with any text editor; for every archive type there must be
  45.  four lines, as folowing:
  46.  
  47. Extension (lower case!)
  48. How to extract .readme
  49. How to extract file_id.diz
  50. How to replace file_id.diz 
  51.  
  52.  If operation is not posible for your archive type (e.g. extracting .readme's
  53.  from GIFs or so), then leave an empty line.
  54.  
  55. Examples:
  56.  
  57. lha
  58. lha e @F T: #?.readme
  59. lha e @F T: file_id.diz
  60. lha r @F T:file_id.diz
  61.  
  62. gif
  63.  
  64. diz_tool @F >T:file_id.diz
  65. diz_tool m @F T:file_id.diz
  66.  
  67.   Via nVmDIZ.diz file:
  68.  
  69.  nVmDIZ.diz file can contain 4 special symbols right now. That are: @F@ for
  70.  filename, @T@ for type, @S@ for short, and @C@ for comment. Argument starts
  71.  with e.g. @F@, and ends with @F@; everything between will be owervriten.
  72.  Note that, right now, it isn't possible to remove completely any of theese
  73.  entries. Also note that, if entries are longer than reserved space, they
  74.  will not be shortened, but everything right will be moved.
  75.  
  76.  Example:
  77.                 _
  78.      ___..__ _.(_).___ ____ _____
  79.     (___l|  Y | | |  / \-___ \   ______________.
  80.   .............$!............................  |
  81.    nVmDIZ from nEVERmIND pRODUCTIONS!       :  !
  82.  -------------------------------------------'---
  83.  Name:@F@@@@@@@@@@@@@@F@   Type:@T@@@@@T@       
  84. Short:@S@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@S@
  85. ComNt:@C@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@C@
  86.  - -- --- ----- ----------- --------------------
  87.  
  88.  Usage:
  89.  
  90. Damned simple! Archive name can be entered in 1st text gadget or get by
  91. clicking on gadget with F on the right side. Same way is for ReadMe file.
  92. Ar gadget on the right will extract all .readmes from archive, and let 
  93. you pick one. Get gadget is for getting Short: and Type: lines from 
  94. .readme file. Of course, you can change this text in text gadgets. When 
  95. everything is finished, click on Make DIZ and you'll see requester which
  96. will show you your file_id.diz. If you are satisfied click on 'Make it'. Then
  97. you will see old file_id.diz, if there was any in the archive (should order
  98. of theese two DIZ's be different? Mail me!). If everything is OK, archive
  99. now contains your file_id.diz .
  100.  
  101. Note: key shortcuts don't work.
  102.  
  103.  ToDo's:
  104.  
  105. (In no particular order)
  106.  
  107. -AmigaGuide documentation :)
  108. -Short: wordwrapping.
  109. -Command line options.
  110. -Nicer icons and GUI.
  111. -C rewritting.
  112.  
  113. -NO signature in DIZ (well, in fact, there is one , but configurable).
  114.  
  115.  Known bugs:
  116.  
  117. -If you set some window X coordinates in WINX tooltype, it will crash your
  118. system. I guess this is bug in AMOSPro GUI, but I'm not sure.
  119.  
  120. If you find any other bugs, mail me!
  121.  
  122.  History:
  123.  
  124. 0.5 Due to lack of feedback this is probably the final release:
  125.  -Now it's possible to edit diz manually before inserting it into archive
  126.  -EDITOR tooltype added
  127.  -Key shortcuts now work! (mostly :)
  128.  -Recompiled with new GUI compiler -> should be much more stable
  129.  -Font sensitive GUI
  130.  -Version string added :)
  131.  -New nVmDIZ icon :)
  132.  -Minor bugfixes
  133.  
  134. 0.4 Now we're comming close:
  135.  -Support for .rea and .rdm files
  136.  -REPLACE, COMMENT tooltypes added
  137.  -Some shorting of code
  138.  -No more idiotic strings in gadgets and requesters (I hope)
  139.  -Installer install script.
  140.  -Smarter file and directory handling
  141.  -Configurable archive types
  142.  
  143. 0.3 More added:
  144.  -WINX, WINY, IWX, IWY and DEFDIR tooltypes
  145.  -Selective arguments position in DIZ file.
  146.  -Edit gadget in DIZ requester, but it's not yet active:)
  147.  -Some bugs fixed
  148.  
  149. 0.2 A few bits added
  150.  -Adding DIZ in archive
  151.  -Bigger and nicer About requester:)
  152.  -Iconifying
  153.  -DIZ preview
  154.  -Asks if DIZ is going to be overwrited
  155.  
  156. 0.1 Initial relase
  157.  
  158.  Author:
  159.  
  160. Please send all your comments, sugestions and bugreports to me. My 
  161. e-mails are:
  162.  
  163. beat.lord@universe.bc.co.yu
  164. smolensk@eunet.yu
  165. smolenski@setnet.co.yu
  166.  
  167. Thank you.
  168.  
  169.  Thanks:
  170.  
  171. Jan van den Baard for his GR8! GadToolsBox.
  172. Petro Ghizzoni for his (also GR8!) AMOSPro GUI extension.
  173. Miroslaw Siedlarz for his GTT procedure.
  174. sule of nEVERmIND for moral support, and for his great ASCIIs.
  175. mr_W of nEVERmIND for moral & code support.
  176.  
  177. Greets to all members of nEVERmIND worldvide! (ehhehe:)
  178.                 _
  179.      ___..__ _.(_).___ ____ _____
  180.     (___l|  Y | | |  / \-___ \   ______________.
  181.   .............$!............................  |
  182.    nVmDIZ from nEVERmIND pRODUCTIONS!       :  !
  183.  -------------------------------------------'---